home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 014a / dfe104.zip / DFE.DOC < prev    next >
Text File  |  1991-08-28  |  47KB  |  1,129 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                            DDDD  FFFFF EEEEE
  14.                            D   D F     E
  15.                            D   D FFF   EE
  16.                            D   D F     E
  17.                            DDDD  F     EEEEE
  18.  
  19.                           Display Font Editor
  20.                              Version 1.04
  21.                             10 August 1991
  22.  
  23.                 Copyright (C) 1991 by Rimrock Software
  24.                           All Rights Reserved
  25.  
  26.  
  27.  
  28.  
  29.                          ┌─────────┐
  30.                    ┌─────┴───┐     │               (R)
  31.                  ──│         │o    │──────────────────
  32.                    │   ┌─────┴╨──┐ │  Association of
  33.                    │   │         │─┘  Shareware
  34.                    └───│    o    │    Professionals
  35.                  ──────│    ║    │────────────────────
  36.                        └────╨────┘    MEMBER
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45. Rimrock Software
  46. P.O. Box 2406
  47. Hayden, ID  83835
  48. (208) 772-9347 (after 6 pm Pacific Time)
  49.  
  50.  
  51.  
  52.                        DFE Shareware Information
  53.  
  54. DFE is a shareware product.  No matter how you obtained this product, 
  55. we encourage you to freely copy and distribute DFE, provided that 
  56.  
  57.     1. No fee is charged beyond normal media duplication and shipping 
  58.        costs. 
  59.  
  60.     2. The DFE archive distribution file must be distributed in its 
  61.        original form.  Specifically, the files listed in the 
  62.        PACKING.LST must be included.  None of these files should be 
  63.        altered, and no new files should be added.  Advertising within 
  64.        the DFE archive file is prohibited. 
  65.  
  66.     3. Commercial use of DFE is prohibited unless the program is 
  67.        registered for the specific number of computers on which it 
  68.        will be used. 
  69.  
  70. See the ORDER.FRM file for more licensing information.
  71.  
  72. If you received DFE as shareware, i.e., you didn't pay a registration 
  73. fee for it or you got it from a shareware library, and you use it on a 
  74. regular basis, you must register the program using the accompanying 
  75. order form.  Registering shareware encourages program authors to 
  76. continue making improvements to programs and to create newer and 
  77. better software. 
  78.  
  79. For your $49 registration fee, you will receive the latest registered 
  80. version of DFE, all accompanying files, and a printed user's manual.  
  81. You will also receive an extensive set of raw font files for use with 
  82. DFE and the DFE Utilities.
  83.  
  84. Rimrock Software is a member of the Association of Shareware 
  85. Professionals (ASP).  ASP wants to make sure that the shareware 
  86. principle works for you.  If you are unable to resolve a shareware-
  87. related problem with an ASP member by contacting the member directly, 
  88. ASP may be able to help.  The ASP Ombudsman can help you resolve a 
  89. dispute or problem with an ASP member, but does not provide technical 
  90. support for members' products.  Please write to the ASP Ombudsman at 
  91. 545 Grover Road, Muskegon, MI  49442-9427 or send a CompuServe message 
  92. via easyplex to ASP Ombudsman 70007,3536 
  93.  
  94.                                     -i-
  95.                            TABLE OF CONTENTS
  96.  
  97.     Introduction to DFE . . . . . . . . . . . . . . . . . . 1
  98.         Overview. . . . . . . . . . . . . . . . . . . . . . 1
  99.         System Requirements . . . . . . . . . . . . . . . . 2
  100.         Technical Support . . . . . . . . . . . . . . . . . 2
  101.         Registration Information. . . . . . . . . . . . . . 2
  102.  
  103.     Using DFE . . . . . . . . . . . . . . . . . . . . . . . 3
  104.         DFE Editing Display . . . . . . . . . . . . . . . . 3
  105.           The Menu Bar. . . . . . . . . . . . . . . . . . . 4
  106.             File Menu . . . . . . . . . . . . . . . . . . . 4
  107.             Edit Menu . . . . . . . . . . . . . . . . . . . 6
  108.             Motion Menu . . . . . . . . . . . . . . . . . . 7
  109.             Util Menu . . . . . . . . . . . . . . . . . . . 8
  110.             Info Menu . . . . . . . . . . . . . . . . . . . 9
  111.           The Font Display Area . . . . . . . . . . . . . . 9
  112.           The File Information Area . . . . . . . . . . . . 9
  113.           The Character Information Area. . . . . . . . . .10
  114.           The Character Edit Area . . . . . . . . . . . . .10
  115.           Editing Controls. . . . . . . . . . . . . . . . .11
  116.  
  117.     DFE Utilities . . . . . . . . . . . . . . . . . . . . .13
  118.         DFLoad - Raw Font Loader. . . . . . . . . . . . . .14
  119.         DFKeep - Load a Raw Font and Keep it. . . . . . . .14
  120.         DFMap  - Map a Raw Font . . . . . . . . . . . . . .14
  121.         Raw2Asc- Convert a Raw File to ASCII. . . . . . . .15
  122.         CPLoad - Code Page File Font Loader . . . . . . . .16
  123.         CPMap  - Map a Code Page Font . . . . . . . . . . .16
  124.         CPInfo - Code Page File Information . . . . . . . .17
  125.         CPI2Asc- Convert a Code Page Font to ASCII. . . . .17
  126.  
  127.     Error Messages. . . . . . . . . . . . . . . . . . . . .18
  128.  
  129.                                    -ii-
  130. Introduction to DFE
  131. -------------------
  132.  
  133.     Overview
  134.     --------
  135.  
  136.     DFE and its utilities allow you to create and use new fonts on 
  137.     your EGA or VGA display.  This is exactly how the Norton Utilities 
  138.     and PC-Tools create their pseudo-graphical interfaces.  
  139.     
  140.     DFE is a graphics-based editor for DOS code page display files 
  141.     (.CPI files) or raw EGA/VGA font files.  Code page files are used 
  142.     by DOS to display characters other than those that would normally 
  143.     be displayed when specific ASCII codes are sent to the display.  
  144.     For instance, if you have set up your system with a russian 
  145.     keyboard driver and wish to display russian cyrillic characters, 
  146.     you would use a font from code page 866. DFE allows you to make 
  147.     changes to existing code pages, or create your own code pages. 
  148.  
  149.     DFE is also capable of editing 'raw' font files.  These are fonts 
  150.     that can be loaded directly into an EGA or VGA using the included 
  151.     DFLoad or DFKeep programs. 
  152.  
  153.     DFE allows you to change a particular font character on a pixel-
  154.     by-pixel basis.  It also allows you to create character sets that 
  155.     are as small as 7 pixels tall or as large as 32 pixels tall (7 
  156.     pixels is a practical limit, not an actual limit). 
  157.     
  158.     The DFE Utilities are included as part of DFE. They provide useful 
  159.     capabilities such as loading a raw font or code page font to the 
  160.     display, mapping a font and converting a font to ASCII. The DFE 
  161.     Utilities are DFLoad, DFKeep, DFMap, Raw2Asc, CPLoad, CPMap, 
  162.     CPInfo and CPI2Asc. 
  163.  
  164.     Programmers who wish to include their own display font within 
  165.     their applications can use DFE to create the font, then use 
  166.     Raw2Asc to convert the font to a form that can be directly 
  167.     incorporated into their C source code.  The font used in DFE's 
  168.     registration reminder screen was generated using Raw2Asc. 
  169.  
  170.     DFE was written in C and compiled with the Borland International 
  171.     C++ compiler.  It uses the TEGL graphics library for all its 
  172.     graphic functions.  TEGL is copyright (c) 1990-1991 by TEGL 
  173.     Systems Corporation, all rights reserved.
  174.  
  175.     The DFE Utilities were written in assembly language and assembled 
  176.     with the Borland International TASM assembler.  They use routines 
  177.     from the Spontaneous Assembly (tm) library. Spontaneous Assembly 
  178.     is copyright (c) 1989-1990 by Acclaim Technologies, Inc., all 
  179.     rights reserved, and is a trademark of Acclaim Technologies, Inc. 
  180.  
  181.                                     -1-
  182.     System Requirements
  183.     -------------------
  184.  
  185.     DOS Version: 2.10 or higher
  186.     Memory:      640k
  187.     Disk drives: 1 floppy or hard disk for file storage/retrieval.
  188.     Display:     EGA, VGA or Hercules display required for DFE; EGA 
  189.                  or VGA required for use with DFLoad, DFKeep and 
  190.                  CPLoad. All other DFE Utilities have no particular 
  191.                  display requirements.
  192.     Other:       A Microsoft compatible mouse and driver is optional 
  193.                  but desirable.
  194.  
  195.     Technical Support
  196.     -----------------
  197.  
  198.     If you have any questions regarding DFE or its utilities, you may 
  199.     call Rimrock Software for technical assistance.  Technical support 
  200.     is available throughout the week, from 6:00 pm to 10:00 pm, 
  201.     Pacific time.  The phone number is (208) 772-9347.  Technical 
  202.     support is NOT limited to registered users, although we encourage 
  203.     you to register the DFE package.
  204.  
  205.     You may reach Rimrock Software on CompuServe.  We regularly 
  206.     monitor the SHAREWARE forum, section 1, for questions about our 
  207.     software.  Please direct your questions to Michael Burton, 
  208.     71211,70. 
  209.  
  210.     You may obtain the latest shareware version of DFE, and ask 
  211.     questions about it, on the Tech Board BBS, (208) 765-0180. The 
  212.     Tech Board sysop is Dan Boss and he has kindly provided an area 
  213.     for support of Rimrock Software products.  Many thanks, Dan. 
  214.         
  215.     Registration Information
  216.     ------------------------
  217.  
  218.     The unregistered versions of DFE and its utilities are fully 
  219.     functional, uncrippled programs. If you find these programs to be 
  220.     useful, you can become a registered user.  Registration entitles 
  221.     you to the latest versions of the programs and a bound, printed 
  222.     manual.  The only difference between the registered and the 
  223.     unregistered versions of the programs is that the registered 
  224.     versions do not have any registration reminders.  An order form is 
  225.     included with DFE, and may be printed by entering the following at 
  226.     the DOS prompt: 
  227.  
  228.         COPY ORDER.FRM PRN
  229.  
  230.     Be sure to fill out all the information on the order form, 
  231.     including the DFE unregistered version you are using. 
  232.  
  233.                                     -2-
  234. Using DFE
  235. ---------
  236.  
  237. DFE is easy to use.  The only file necessary is DFE.EXE.  To run the 
  238. program, simply enter 
  239.  
  240.         DFE
  241.  
  242. No command line options are available.  When DFE executes, you will 
  243. see a registration request screen.  You may continue on to the DFE 
  244. editing display by pressing any key. 
  245.  
  246.     DFE Editing Display
  247.     -------------------
  248.  
  249.     Other than the registration request screen, the only other display 
  250.     in DFE is the editing display.  There are six major areas in the 
  251.     editing display (see figure 1); the menu bar, the font display 
  252.     area, the file information area, the character information area, 
  253.     the character edit area and the editing controls area. 
  254.  
  255.  
  256. +--------------------------------------------------------------------+
  257. | File  Edit  Motion  Util  Info                Unregistered Version |
  258. +--------------------------------------------------------------------+
  259. |                                                                    |
  260. | +-----------+ +-----------+      +---------------------------+     |
  261. | |           | |Char No: 0 |      |File:         Code Page:0  |     |
  262. | |           | |Default:   |      |Device Name:       Font:0  |     |
  263. | |           | |           |      +---------------------------+     |
  264. | |           | |PX:        | +------------------------------------+ |
  265. | |           | |PY:        | |                                    | |
  266. | |           | |Height: 14 | |                                    | |
  267. | |           | +-----------+ |                                    | |
  268. | |           |+--+           |                                    | |
  269. | |           ||  |           |                                    | |
  270. | |           |+--+ +-------+ |                                    | |
  271. | |           |+--+ |Display| |                                    | |
  272. | |[character ||  | |Font   | |                                    | |
  273. | | edit area]|+--+ |Editor | |        [font display area]         | |
  274. | |           |+--+ +-------+ |                                    | |
  275. | |           ||  |           |                                    | |
  276. | |           |+--+           |                                    | |
  277. | |           |+--+           |                                    | |
  278. | |           ||  |           |                                    | |
  279. | |           |+--+           |                                    | |
  280. | |           |+--+           |                                    | |
  281. | |           ||  |           |                                    | |
  282. | |           |+--+           |                                    | |
  283. | |           |+--+           |                                    | |
  284. | |           ||  |           |                                    | |
  285. | |           |+--+           |                                    | |
  286. | +-----------+               +------------------------------------+ |
  287. |                                                                    |
  288. +--------------------------------------------------------------------+
  289.  
  290.                      Figure 1  DFE Editing Display
  291.     
  292.                                     -3-
  293.     You may use either the cursor keys or your mouse to move the DFE 
  294.     cursor around.  The keyboard cursor keys give you fast movement 
  295.     and the numeric keys give you fine control.  When you wish to 
  296.     select something, you can do so with the Enter key.  If you use a 
  297.     mouse, you may select something by clicking the left mouse button.  
  298.     The right mouse button can be used to move some of the objects on 
  299.     the screen, but you wouldn't normally want to do this.
  300.  
  301.         The Menu Bar
  302.         ------------
  303.  
  304.         The Menu Bar contains functions that read and write files, 
  305.         control editing, control motion within a font, control utility 
  306.         functions and display information about DFE.  Each Menu Bar 
  307.         header is connected to a pull down menu of items that may be 
  308.         selected for execution.
  309.  
  310.             File Menu
  311.             ---------
  312.  
  313.             The file menu is used to load and save fonts, and to leave 
  314.             DFE when you are finished. It contains five items, 
  315.             detailed below (see figure 2).
  316.  
  317.                            File
  318.                           +----------------+
  319.                           | Load Code Page |
  320.                           | Save Code Page |
  321.                           +----------------+
  322.                           | Load Raw Font  |
  323.                           | Save Raw Font  |
  324.                           +----------------+
  325.                           | Quit to DOS    |
  326.                           +----------------+
  327.  
  328.                           Figure 2  File Menu
  329.  
  330.             In general, when you select a file load or save item, a 
  331.             pop up file selection window appears (see figure 3).  This 
  332.             window contains the name of the current directory, a list 
  333.             of file names and subdirectories in the current directory, 
  334.             an empty file name box, an up arrow, a horizontal bar, a 
  335.             down arrow, a Cancel button and an Ok button. 
  336.             
  337.             To select a file for loading or saving, click on its name 
  338.             and the file will be displayed in the file name box.  Then 
  339.             click on the Ok button and the file will be loaded or 
  340.             saved.  Alternatively, you may click on the file name box 
  341.             and an editing cursor will appear.  You may then type in a 
  342.             file name.  When you are finished, press the Enter key, 
  343.             Then click on the Ok button. 
  344.             
  345.                                     -4-
  346.             If you want to move around in the file list, click on the 
  347.             down arrow or up arrow. If you want to move to a sub-
  348.             directory, click on the directory in the file list. If you 
  349.             want to move towards the root directory, click on the 
  350.             horizontal bar between the arrows.  
  351.             
  352.             If you want to change disk drives, keep clicking on the 
  353.             horizontal bar until you see a list of disk drives, then 
  354.             click on the drive you want. 
  355.  
  356.                   +---------------------------------+
  357.                   |H:\DFE\*.*                       |
  358.                   +---------------------------------+
  359.                   |                                 |
  360.                   | * TEMP           +------------+ |
  361.                   |   DFE     .EXE   |            | |
  362.                   |   DFE     .MAN   +------------+ |
  363.                   |   BACKWARD.RAW     ^            |
  364.                   |   BOLD    .RAW    / \  +------+ |
  365.                   |   ICONS   .RAW    | |  |CANCEL| |
  366.                   |                   +-+  +------+ |
  367.                   |                   ===           |
  368.                   |                   +-+  +------+ |
  369.                   |                   | |  |  OK  | |
  370.                   |                   \ /  +------+ |
  371.                   |                    v            |
  372.                   +---------------------------------+
  373.  
  374.                     Figure 3  File Selection Window
  375.  
  376.             Load Code Page
  377.  
  378.             Load Code Page allows you to load a particular font from a 
  379.             code page file and edit the font.  You must select the 
  380.             proper code page file, then you must select the proper 
  381.             code page and font.  The standard U.S. code page is 437, 
  382.             and there are usually 3 fonts in it - an 8x16, an 8x14 and 
  383.             an 8x8 font. 
  384.  
  385.             Save Code Page
  386.  
  387.             Save Code Page allows you to save the font you are 
  388.             currently working on into a code page file.  This can be 
  389.             any font, including a raw font.  When selected, this item 
  390.             first asks for a code page file name. It then asks for a 
  391.             device name.  In most code page display files, the device 
  392.             name is either EGA or LCD.  It then asks for a code page 
  393.             id.  This is where you enter the code page number, such as 
  394.             437.  Finally, if the code page id exists, it will tell 
  395.             you how many fonts are currently in that code page 
  396.             and will ask you where it should be saved.  If you pick 
  397.     
  398.                                     -5-
  399.             one of the fonts already present, it will be replaced with 
  400.             the font you are currently editing.  If you pick the next 
  401.             higher number, the font you are editing will be added to 
  402.             the code page file.
  403.  
  404.             Load Raw Font
  405.  
  406.             Load Raw Font allows you to load a raw font for editing.  
  407.             Simply pick the file of your choice and it will be loaded.  
  408.             If the file you pick is not a raw font file, an error 
  409.             message will indicate this fact. 
  410.  
  411.             Save Raw Font
  412.  
  413.             Save Raw Font allows you to save your current work in a 
  414.             raw font file.  You may pick an already existing file to 
  415.             save in, or you may enter your own file name.  Although 
  416.             you may use any extension you wish, we have picked an 
  417.             extension of .RAW for our files.  For consistency, we 
  418.             suggest you do the same.  Be careful - DFE will write over 
  419.             an existing file without asking permission. 
  420.  
  421.             Quit to DOS
  422.  
  423.             Quit to DOS allows you to leave DFE and return to DOS.  BE 
  424.             CAREFUL - DFE will return immediately to DOS regardless of 
  425.             whether you have saved your work or not. 
  426.  
  427.             Edit Menu
  428.             ---------
  429.  
  430.             Edit menu items allow you to make changes to the currently 
  431.             selected character or the entire selected font set.  The 
  432.             edit menu has five items (see figure 4).
  433.  
  434.                             Edit
  435.                            +--------------+
  436.                            | Clear Char   |
  437.                            | Clear All    |
  438.                            +--------------+
  439.                            | Copy Char    |
  440.                            | Default Char |
  441.                            | Default Set  |
  442.                            +--------------+
  443.  
  444.                           Figure 4  Edit Menu
  445.  
  446.             Clear Char
  447.  
  448.             Clear Char erases all the pixels in the currently selected 
  449.             character. 
  450.  
  451.                                     -6-
  452.             Clear All
  453.  
  454.             Clear All erases the entire font set.  You will be asked 
  455.             if you are sure before the set is erased. 
  456.  
  457.             Copy Char
  458.  
  459.             When Copy Char is selected, you will be asked to select 
  460.             another character from the font set.  That character will 
  461.             then be copied into the current character. 
  462.  
  463.             Default Char
  464.  
  465.             Default Char copies the character in your display adapter 
  466.             ROM that coincides with the current character into the 
  467.             current character. 
  468.  
  469.             Default Set
  470.  
  471.             Default Set copies the entire character set from your 
  472.             display adapter ROM into the current font set.  You will 
  473.             be asked if you really want to do this before it is done.  
  474.             This is a good way to create a basic character set that 
  475.             you can then modify. 
  476.  
  477.             Motion Menu
  478.             -----------
  479.  
  480.             The Motion Menu controls the current character. You may 
  481.             move forward or backward in the font set, or you may 
  482.             select a font character at random (see figure 5). 
  483.  
  484.                                Motion
  485.                               +--------------------+
  486.                               | Next Character     |
  487.                               | Previous Character |
  488.                               +--------------------+
  489.                               | Select A Character |
  490.                               +--------------------+
  491.  
  492.                                Figure 5  Motion Menu
  493.  
  494.             Next Character
  495.  
  496.             Next Character makes the next character in the font set 
  497.             the current character.  The character information area is 
  498.             updated and the character is drawn in the character 
  499.             editing area. 
  500.  
  501.                                     -7-
  502.             Previous Character
  503.  
  504.             Previous Character makes the previous character in the 
  505.             font set the current character.  The character information 
  506.             area is updated and the character is drawn in the 
  507.             character editing area. 
  508.  
  509.             Select A Character
  510.  
  511.             When Select A Character is activated, you are asked to 
  512.             select a character from the font set.  When you click on a 
  513.             particular character, that character becomes the current 
  514.             character.  The character information area is updated and 
  515.             the character is drawn in the character editing area. 
  516.  
  517.             Util Menu
  518.             ---------
  519.  
  520.             The Util Menu contains miscellaneous DFE functions.  The 
  521.             menu has three items (see figure 6).
  522.  
  523.                                 Util
  524.                                +-------------------+
  525.                                | Character Height  |
  526.                                | Set Separation    |
  527.                                | Mouse Sensitivity |
  528.                                +-------------------+
  529.  
  530.                                 Figure 6  Util Menu
  531.  
  532.             Character Height
  533.  
  534.             Character Height allows you to change the number of pixel 
  535.             rows in a character.  Be careful, because if you change 
  536.             from more rows to less rows and back to more rows, you may 
  537.             lose the lower pixels of each character in the font set. 
  538.  
  539.             Set Separation
  540.  
  541.             Set Separation is used to control how the font set is 
  542.             displayed in the font display area.  The initial display 
  543.             is no separation - characters are displayed with no pixels 
  544.             in between.  Selecting this item alternates between 
  545.             separation and no separation. 
  546.  
  547.             Mouse Sensitivity
  548.  
  549.             Mouse Sensitivity allows you to control the speed and 
  550.             sensitivity of the mouse in DFE.  It allows you to change 
  551.             horizontal and vertical sensitivity and the double speed 
  552.             threshold of the mouse. 
  553.  
  554.                                     -8-
  555.             Info Menu
  556.             ---------
  557.  
  558.             The Info Menu contains information about DFE and how to 
  559.             register the DFE package (see figure 7).
  560.  
  561.                                    Info
  562.                                   +------------+
  563.                                   | About      |
  564.                                   | Order Form |
  565.                                   +------------+
  566.  
  567.                                 Figure 7  Info Menu
  568.  
  569.             About DFE
  570.  
  571.             About contains information about the date and version of 
  572.             DFE and directs you to Order Form for more information. 
  573.  
  574.             Order Form
  575.  
  576.             Order Form displays information about how to create an 
  577.             order form, so you can register the DFE package. 
  578.  
  579.     The Font Display Area
  580.     ---------------------
  581.  
  582.     The Font Display Area shows you an accurate picture of every 
  583.     character in the font set you are currently working on.  Each font 
  584.     character is initially displayed adjacent to the next, so you can 
  585.     get an idea of how the font will look when you actually use it.  
  586.     If you need to spread the characters out to get a better look at 
  587.     them, you can click on the Set Separation item in the Util menu.
  588.  
  589.     The File Information Area
  590.     -------------------------
  591.  
  592.     The File Information Area contains information concerning where 
  593.     the current font set came from.  If the font set came from a raw 
  594.     font file, the raw font file name will be displayed and all other 
  595.     fields will be blank or zero.  If the font set came from a code 
  596.     page file, the file name will be displayed, along with the code 
  597.     page id, device name and font number (see figure 8).
  598.  
  599.                  +----------------------------------+
  600.                  | File: DFE.CPI     Code Page: 437 |
  601.                  | Device Name: EGA    Font No: 2   |
  602.                  +----------------------------------+
  603.  
  604.                     Figure 8  File Information Area
  605.  
  606.                                     -9-
  607.     The Character Information Area
  608.     ------------------------------
  609.  
  610.     The Character Information Area contains information about the 
  611.     currently selected character.  The information includes the 
  612.     character number (0-255), what the default character looks like, 
  613.     what this character looks like, the current X/Y coordinates of the 
  614.     mouse cursor within the Character Edit Area, and the current 
  615.     height of the entire font set (see figure 9).
  616.  
  617.                             +-------------+
  618.                             | Char No: 65 |
  619.                             | Default: A  |
  620.                             | Current: A  |
  621.                             |             |
  622.                             | PX: 7       |
  623.                             | PY: 3       |
  624.                             | Height: 14  |
  625.                             +-------------+
  626.  
  627.                  Figure 9  Character Information Area
  628.  
  629.     The Character Edit Area
  630.     -----------------------
  631.  
  632.     The Character Edit Area is where all the real action takes place 
  633.     in DFE (see figure 10). The current character is displayed here in 
  634.     a magnified view. You may set or clear any pixels of the 
  635.     character.  To set a pixel, move to it and click.  To clear a 
  636.     pixel, do the same thing.  To set or clear several pixels, move to 
  637.     the first pixel and press the left mouse button and hold it down, 
  638.     then drag the mouse cursor to the next pixel, etc.  The editing 
  639.     controls also allow you to make changes to the character displayed 
  640.     here. 
  641.  
  642.                                    -10-
  643.                            +-+-+-+-+-+-+-+-+
  644.                            | | | | | | | | |
  645.                            +-+-+-+-+-+-+-+-+
  646.                            | | | | | | | | |
  647.                            +-+-+-+-+-+-+-+-+
  648.                            | | |*|*|*| | | |
  649.                            +-+-+-+-+-+-+-+-+
  650.                            | |*|*| |*|*| | |
  651.                            +-+-+-+-+-+-+-+-+
  652.                            |*|*| | | |*|*| |
  653.                            +-+-+-+-+-+-+-+-+
  654.                            |*|*| | | |*|*| |
  655.                            +-+-+-+-+-+-+-+-+
  656.                            |*|*| | | |*|*| |
  657.                            +-+-+-+-+-+-+-+-+
  658.                            |*|*|*|*|*|*|*| |
  659.                            +-+-+-+-+-+-+-+-+
  660.                            |*|*| | | |*|*| |
  661.                            +-+-+-+-+-+-+-+-+
  662.                            |*|*| | | |*|*| |
  663.                            +-+-+-+-+-+-+-+-+
  664.                            |*|*| | | |*|*| |
  665.                            +-+-+-+-+-+-+-+-+
  666.                            | | | | | | | | |
  667.                            +-+-+-+-+-+-+-+-+
  668.                            | | | | | | | | |
  669.                            +-+-+-+-+-+-+-+-+
  670.                            | | | | | | | | |
  671.                            +-+-+-+-+-+-+-+-+
  672.                            |               |
  673.                            |               |
  674.                            |               |
  675.                            |               |
  676.                            |               |
  677.                            |               |
  678.                            |               |
  679.                            +---------------+
  680.  
  681.                     Figure 10  Character Edit Area
  682.  
  683.     Editing Controls
  684.     ----------------
  685.  
  686.     The Editing Controls allow gross changes to be made to the 
  687.     character.  The controls are located adjacent to the Character 
  688.     Edit Area.  There are nine controls; up arrow, down arrow, left 
  689.     arrow, right arrow, horizontal double arrow, vertical double 
  690.     arrow, inverted A, NXT and PRV (see figure 11). 
  691.  
  692.                                    -11-
  693.                                  +---+
  694.                                  | ^ |
  695.                                  +---+
  696.                                  +---+
  697.                                  | v |
  698.                                  +---+
  699.                                  +---+
  700.                                  |<--|
  701.                                  +---+
  702.                                  +---+
  703.                                  |-->|
  704.                                  +---+
  705.                                  |<->|
  706.                                  +---+
  707.                                  +---+
  708.                                  |^v |
  709.                                  +---+
  710.                                  +---+
  711.                                  | A |
  712.                                  +---+
  713.                                  +---+
  714.                                  |NXT|
  715.                                  +---+
  716.                                  +---+
  717.                                  |PRV|
  718.                                  +---+
  719.  
  720.                       Figure 11  Editing Controls
  721.  
  722.     When you click on the up arrow control, the entire character is 
  723.     moved up by one pixel row.  The top row of pixels is lost.
  724.  
  725.     When you click on the down arrow control, the entire character is 
  726.     moved down by one pixel row.  The bottom row of pixels is lost.
  727.  
  728.     When you click on the left arrow control, the entire character is 
  729.     moved to the left by one pixel column.  The left column of pixels 
  730.     is lost.
  731.  
  732.     When you click on the right arrow control, the entire character is 
  733.     moved to the right by one pixel column.  The right column of 
  734.     pixels is lost.
  735.  
  736.     Clicking on the horizontal double arrow flips the character over 
  737.     horizontally, i.e., a left to right mirror image of the character 
  738.     is produced.
  739.  
  740.     Clicking on the vertical double arrow flips the character over 
  741.     vertically, i.e., a top to bottom mirror image of the character is 
  742.     produced.
  743.  
  744.                                    -12-
  745.     Clicking on the inverted A inverts the character.  All the pixels 
  746.     that were set are cleared and all the pixels that were clear are 
  747.     set. 
  748.  
  749.     Clicking on NXT is the same as selecting Next Character from the 
  750.     motion menu - the next character in the font set is made the 
  751.     current character.  All the current character information is 
  752.     updated and the new character will be displayed in the Character 
  753.     Editing Area. 
  754.  
  755.     Clicking on PRV is the same as selecting Previous Character from 
  756.     the motion menu - the previous character in the font set is made 
  757.     the current character.  All the current character information is 
  758.     updated and the new character is displayed in the Character 
  759.     Editing Area. 
  760.  
  761. DFE Utilities
  762. -------------
  763.  
  764. The DFE Utilities are a set of programs that helps you use and 
  765. maintain raw font and code page files.  If you forget how to use a 
  766. particular program, each one has built-in help.  Simply execute the 
  767. program with no command line arguments and a syntax message will be 
  768. displayed.
  769.  
  770. All of the DFE Utilities support DOS I/O redirection. All of the 
  771. screen display for a particular utility may be directed to another I/O 
  772. device.  For instance, to print a DFMap of a raw font on your printer, 
  773. you enter 
  774.  
  775.     DFMAP ICONS.RAW >PRN
  776.  
  777. or
  778.  
  779.     DFMAP ICONS.RAW >LPT1
  780.  
  781. To direct the output of DFMap to a file called ICONS.TXT instead of 
  782. printing it, you enter 
  783.  
  784.     DFMAP ICONS.RAW >ICONS.TXT
  785.  
  786. To append more to the file just created, you would enter
  787.  
  788.     DFMAP BLOCK.RAW >>ICONS.TXT
  789.  
  790. Only the display I/O may be redirected.  Normal file I/O cannot be 
  791. redirected. 
  792.  
  793.                                    -13-
  794.     DFLoad - Raw Font Loader
  795.     ------------------------
  796.  
  797.     DFLoad is the workhorse of the DFE utilities.  It is used to load 
  798.     a raw font into an EGA or VGA display adapter and make that font 
  799.     the current display font.  To use DFLoad, you enter
  800.  
  801.         DFLOAD d:\path\filename.ext
  802.  
  803.     where d is the drive, path is the directory path, filename is the 
  804.     name of the raw font file and ext is the file extension.  Don't 
  805.     forget to include the file extension, if there is one.  DFLoad 
  806.     makes no assumptions about file extensions. 
  807.  
  808.     DFKeep - Load a Raw Font and Keep it
  809.     ------------------------------------
  810.  
  811.     DFKeep is a terminate and stay resident (TSR) version of DFLoad.  
  812.     It loads a new font into your display adapter, but if you switch 
  813.     display modes and then come back to text mode, DFKeep will reload 
  814.     the font.  This means you can go into Windows and when you leave 
  815.     it, your fancy DFE raw font will be used.  DFKeep is used the same 
  816.     way as DFLoad
  817.  
  818.         DFKEEP d:\path\filename.ext
  819.  
  820.     where d is the drive, path is the directory path, filename is the 
  821.     name of the raw font file and ext is the file extension.  Don't 
  822.     forget to include the file extension, if there is one.  DFKeep 
  823.     makes no assumptions about file extensions. 
  824.  
  825.     DFKeep will only be loaded into memory one time.  Subsequent 
  826.     execution of DFKeep will change the raw font being used.  For 
  827.     instance
  828.  
  829.         DFKEEP BOLD.RAW    will load DFKeep - BOLD.RAW is the font
  830.         DFKEEP ICONS.RAW   will change the font to ICONS.RAW
  831.  
  832.     DFKeep cannot be unloaded from memory once it is installed.
  833.  
  834.     DFMap  - Map a Raw Font
  835.     -----------------------
  836.  
  837.     DFMap allows you to create a visual map of an entire raw font set.  
  838.     An example portion of DFMap's output is shown in figure 12.
  839.  
  840.                                    -14-
  841.     #48  30h
  842.     -------- -------- -------- -------- -------- -------- --------
  843.     -------- -------- -------- -------- -------- -------- --------
  844.     -@@@@@-- ---@@--- -@@@@@-- -@@@@@-- ----@@-- @@@@@@@- -@@@@@--
  845.     @@---@@- -@@@@--- @@---@@- @@---@@- ---@@@-- @@------ @@---@@-
  846.     @@--@@@- ---@@--- @@---@@- -----@@- --@@@@-- @@------ @@------
  847.     @@-@@@@- ---@@--- ----@@-- -----@@- -@@-@@-- @@------ @@------
  848.     @@@@-@@- ---@@--- ---@@--- --@@@@-- @@--@@-- @@@@@@-- @@@@@@--
  849.     @@@--@@- ---@@--- --@@---- -----@@- @@@@@@@- -----@@- @@---@@-
  850.     @@---@@- ---@@--- -@@----- -----@@- ----@@-- -----@@- @@---@@-
  851.     @@---@@- ---@@--- @@---@@- @@---@@- ----@@-- @@---@@- @@---@@-
  852.     -@@@@@-- -@@@@@@- @@@@@@@- -@@@@@-- ----@@-- -@@@@@-- -@@@@@--
  853.     -------- -------- -------- -------- -------- -------- --------
  854.     -------- -------- -------- -------- -------- -------- --------
  855.     -------- -------- -------- -------- -------- -------- --------
  856.  
  857.                     Figure 12  Sample DFMap Output
  858.  
  859.     To use DFMap, you enter
  860.  
  861.         DFMAP d:\path\filename.ext
  862.  
  863.     where d is the drive, path is the directory path, filename is the 
  864.     name of the raw font file and ext is the file extension.  Don't 
  865.     forget to include the file extension, if there is one.  DFMap 
  866.     makes no assumptions about file extensions. 
  867.  
  868.     Raw2Asc- Convert a Raw File to ASCII
  869.     ------------------------------------
  870.  
  871.     Raw2Asc is used to convert a raw font file into an ASCII form that 
  872.     can be directly inserted into a C source file (see figure 13 for a 
  873.     sample portion of a Raw2Asc .ASC file).
  874.  
  875.     0x00,0x00,0x7E,0x81,0xA5,0x81,0x81,0xBD,0x99,0x81,0x7E,0x00,0x00,
  876.     0x00,0x00,0x7E,0xFF,0xDB,0xFF,0xFF,0xC3,0xE7,0xFF,0x7E,0x00,0x00,
  877.     0x00,0x00,0x00,0x6C,0xEE,0xFE,0xFE,0xFE,0x7C,0x38,0x10,0x00,0x00,
  878.     0x00,0x00,0x00,0x10,0x38,0x7C,0xFE,0x7C,0x38,0x10,0x00,0x00,0x00,
  879.     0x00,0x00,0x00,0x10,0x38,0x10,0x6C,0xEE,0x6C,0x10,0x38,0x00,0x00,
  880.     0x00,0x00,0x10,0x38,0x7C,0x7C,0xFE,0xFE,0x6C,0x10,0x38,0x00,0x00,
  881.  
  882.               Figure 13  Sample Raw2Asc .ASC File Output
  883.  
  884.     To use Raw2Asc, you enter
  885.  
  886.         RAW2ASC d:\path\filename.ext
  887.  
  888.     where d is the drive, path is the directory path, filename is the 
  889.     name of the raw font file and ext is the file extension.  Don't 
  890.     forget to include the file extension, if there is one.  Raw2Asc 
  891.     makes no assumptions about file extensions. 
  892.  
  893.                                    -15-
  894.     Raw2Asc will create its ASCII file on the same drive and in the 
  895.     same directory with the same file name, but with an extension of 
  896.     .ASC. 
  897.  
  898.     CPLoad - Code Page File Font Loader
  899.     -----------------------------------
  900.  
  901.     CPLoad is used to load a font from a code page file into an EGA or 
  902.     VGA display adapter and make that font the current display font.  
  903.     This gives you a reality check on the font without having to go 
  904.     through the awkward DOS font loading process.  To use CPLoad, you 
  905.     enter 
  906.  
  907.         CPLOAD d:\path\filename.ext code_page font_number
  908.  
  909.     where d is the drive, path is the directory path, filename is the 
  910.     name of the code page file and ext is the .CPI extension.  Don't 
  911.     forget to include the .CPI file extension.  CPLoad makes no 
  912.     assumptions about file extensions. 
  913.  
  914.     code_page is the code page number that contains the font you wish 
  915.     to load.  font_number is the font number you wish to load.  For 
  916.     instance, if you wanted to load the 8x8 font (font #3) of code 
  917.     page 437, you enter
  918.  
  919.         CPLOAD DFE.CPI 437 3
  920.  
  921.     CPMap  - Map a Code Page Font
  922.     -----------------------------
  923.  
  924.     CPMap allows you to create a visual map of a code page font.  
  925.     CPMap's output is the same as DFMap's.  See figure 12 for an 
  926.     example.
  927.  
  928.     To use CPMap, you enter
  929.  
  930.         CPMAP d:\path\filename.ext code_page font_number
  931.  
  932.     where d is the drive, path is the directory path, filename is the 
  933.     name of the code page file and ext is the .CPI extension.  Don't 
  934.     forget to include the .CPI file extension.  CPMap makes no 
  935.     assumptions about file extensions. 
  936.  
  937.     code_page is the code page number that contains the font you wish 
  938.     to map.  font_number is the font number you wish to map.  For 
  939.     instance, if you wanted to map the 8x16 font (font #1) of code 
  940.     page 850, you enter 
  941.  
  942.         CPMAP DFE.CPI 850 1
  943.  
  944.                                    -16-
  945.     CPInfo - Code Page File Information
  946.     -----------------------------------
  947.  
  948.     CPInfo provides you with specific information about the code pages 
  949.     and fonts contained within a particular code page file (see figure 
  950.     15).
  951.  
  952.                       Code Page File: dfe.cpi
  953.                       Number of Code Pages: 7
  954.  
  955.                       Code Page: 437
  956.                       Device Name: EGA     
  957.                       Number of fonts: 3
  958.                       Font: 16 rows by 8 columns
  959.                       Font: 14 rows by 8 columns
  960.                       Font: 8 rows by 8 columns
  961.  
  962.                       Code Page: 850
  963.                       Device Name: EGA     
  964.                       Number of fonts: 3
  965.                       Font: 16 rows by 8 columns
  966.                       Font: 14 rows by 8 columns
  967.                       Font: 8 rows by 8 columns
  968.  
  969.                    Figure 15  Partial CPInfo Output
  970.  
  971.     To use CPInfo, you enter
  972.  
  973.         CPINFO d:\path\filename.ext
  974.  
  975.     where d is the drive, path is the directory path, filename is the 
  976.     name of the code page file and ext is the .CPI extension.  Don't 
  977.     forget to include the .CPI extension.  CPInfo makes no assumptions 
  978.     about file extensions. 
  979.  
  980.     For instance, to obtain information about DFE.CPI, enter
  981.  
  982.         CPINFO DFE.CPI
  983.  
  984.     CPI2Asc - Convert a Code Page Font to ASCII
  985.     -------------------------------------------
  986.  
  987.     CPI2Asc is used to convert a code page font file into an ASCII 
  988.     form that can be directly inserted into a C source file.  The 
  989.     ASCII file generated by CPI2Asc is identical to one generated by 
  990.     Raw2Asc.  See figure 13 for an example of file output.
  991.  
  992.     To use CPI2Asc, you enter
  993.  
  994.         CPI2ASC d:\path\filename.ext code_page font_number
  995.  
  996.                                    -17-
  997.     where d is the drive, path is the directory path, filename is the 
  998.     name of the code page file and ext is the .CPI extension.  Don't 
  999.     forget to include the .CPI extension.  CPI2Asc makes no 
  1000.     assumptions about file extensions. 
  1001.  
  1002.     code_page is the code page number that contains the font you wish 
  1003.     to convert.  font_number is the font number you wish to convert.  For 
  1004.     instance, if you wanted to convert the 8x14 font (font #2) of code 
  1005.     page 852 to ASCII, you enter
  1006.  
  1007.         CPI2ASC DFE.CPI 852 2
  1008.  
  1009.     CPI2Asc will create its ASCII file on the same drive and in the 
  1010.     same directory with the same file name, but with an extension of 
  1011.     .ASC. 
  1012.  
  1013. Error Messages
  1014. --------------
  1015.  
  1016. Error messages generated by DFE and its utilities are listed below 
  1017. with an explanation of each message.  The program(s) that generate the 
  1018. message is shown in brackets below the error message.
  1019.  
  1020. Bad code page number 
  1021. [CPLoad CPMap CPI2Asc]
  1022.  
  1023.     The code page number you typed on the command line is not a code 
  1024.     page contained in this code page file.  Use CPInfo to find out 
  1025.     what code pages are in the file.
  1026.  
  1027. Bad font number 
  1028. [CPLoad CPMap CPI2Asc]
  1029.  
  1030.     The font number you typed on the command line is not contained in 
  1031.     this code page.  Use CPInfo to find out what fonts are contained 
  1032.     in this code page.
  1033.  
  1034. Bad raw font file. File not read.
  1035. [DFE]
  1036.  
  1037.     The selected file is not a raw font file.  File sizes for raw 
  1038.     fonts are all multiples of 256. 
  1039.  
  1040. Can't open the .ASC file 
  1041. [Raw2Asc CPI2Asc]
  1042.  
  1043.     The program could not create the requested ASCII file.  This 
  1044.     usually indicates a full disk or a write-protected disk. 
  1045.  
  1046.                                    -18-
  1047. Can't read the file 
  1048. [CPLoad CPMap CPI2Asc]
  1049.  
  1050.     The program found the file and opened it to be read, but for some 
  1051.     unknown reason it could not read anything from the file.  This 
  1052.     could indicate some kind of hardware problem.
  1053.  
  1054. Can't read the font file 
  1055. [CPInfo DFLoad DFMap Raw2Asc]
  1056.  
  1057.     The program found the file and opened it to be read, but for some 
  1058.     unknown reason it could not read anything from the file.  This 
  1059.     could indicate some kind of hardware problem.
  1060.  
  1061. Code page file not found. 
  1062. [CPInfo CPLoad CPMap]
  1063.  
  1064.     The code page file you specified on the command line was not found 
  1065.     where you said it was.  Make sure you have the correct drive, 
  1066.     path, filename and extension. 
  1067.  
  1068. Display adapter is not an EGA, VGA or MCGA 
  1069. [CPLoad DFLoad]
  1070.  
  1071.     The DFE loaders can only change display fonts for EGAs, VGAs (any 
  1072.     flavor), and MCGAs.
  1073.  
  1074. Font file not found 
  1075. [DFLoad DFKeep DFMap Raw2Asc]
  1076.  
  1077.     The raw font file you specified on the command line was not found 
  1078.     where you said it was.  Make sure you have the correct drive, 
  1079.     path, filename and extension. 
  1080.  
  1081. Not a code page file 
  1082. [CPInfo CPLoad CPMap CPI2Asc]
  1083.  
  1084.     The file entered on the command line is not a code page file.  
  1085.     Make sure you have entered the proper drive, path, file name AND 
  1086.     extension.
  1087.  
  1088. Not a display code page file 
  1089. [CPInfo CPLoad CPMap CPI2Asc]
  1090.  
  1091.     The file entered on the command line is a printer code page file, 
  1092.     not a display code page file.
  1093.  
  1094. Not a font file 
  1095. [DFLoad DFMap Raw2Asc]
  1096.  
  1097.     The selected file is not a raw font file.  File sizes for raw 
  1098.     fonts are all multiples of 256. 
  1099.  
  1100.                                    -19-
  1101. Not a font file. File not read.
  1102. [DFE]
  1103.  
  1104.     The selected .CPI is not a display file.  It is probably a printer 
  1105.     code page file. 
  1106.  
  1107. Not enough memory to run program 
  1108. [CPInfo CPLoad CPMap DFLoad DFMap Raw2Asc CPI2Asc]
  1109.  
  1110.     There isn't enough memory left to run the program.  If you got 
  1111.     this message, something is really wrong with your system, since 
  1112.     each of these programs requires less than 20k to run in.
  1113.  
  1114. Out of memory. File not read.
  1115. [DFE]
  1116.  
  1117.     There isn't enough memory left for DFE to read the code page file.  
  1118.     Free up some memory by removing TSRs or device drivers, then run 
  1119.     DFE again.
  1120.  
  1121. Can't read the file 
  1122. [CPLoad CPMap CPI2Asc]
  1123.  
  1124.     The program found the file and opened it to be read, but for some 
  1125.     unknown reason it could not read anything from the file.  This 
  1126.     could indicate a bad .CPI file or some kind of hardware problem.
  1127.  
  1128.                                    -20-
  1129.